home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / btrieve / btrvpa.arc / BTRVPAGE.DOC next >
Text File  |  1989-07-16  |  5KB  |  117 lines
  1.  
  2.  ****************************************************************************
  3.           BTRIEVE Data Page Size Programs for Fixed Record Lengths
  4.  ****************************************************************************
  5.  
  6.     By: Charles Winser    July 14, 1989
  7.  
  8.     Computer: IBM PC and compatibles.
  9.     Development Environment: Turbo C and Microsoft Assembler
  10.  
  11.     Contents of BTRVPAGE.ARC / BTRVPAGE.ZIP
  12.  
  13.      1) BTRVPAGE.EXE  -  Version 1.0
  14.                          Command line standard text output program.
  15.         Usage: 
  16.                BTRVPAGE [Record Size] [Duplicate Keys]
  17.  
  18.                Acceptable range of record length size: 4 - 4090 bytes
  19.                Acceptable range of duplicates keys:    0 - 24 keys
  20.  
  21.  
  22.      2) PAGEBTRV.EXE  -  Version 2.0
  23.                          Program with color windows, error-checking, 
  24.                          context-sensitive help, and sound effects. 
  25.                          (Requires ANSI.SYS device driver)
  26.         Usage:
  27.                PAGEBTRV
  28.  
  29.  
  30.      3) BTRVPAGE.DOC  -  What you are reading now.
  31.  
  32.  
  33.    Included are two programs that calculate the optimum data page size
  34.    while working with standard Btrieve files and fixed record lengths.
  35.    The programs asks for the record length in bytes and the number of
  36.    keys that allow for duplicate values. The number of duplicate keys
  37.    is essential to determine the correct and actual size of the record
  38.    that is inserted into a Btrieve file. Each duplicate key requires 
  39.    8 extra bytes to be store with each record in addition to the 6
  40.    bytes overhead required per data page. The programs select the best
  41.    data page size with the least number of unused bytes remaining. Each
  42.    data page size from 512 to 4096 bytes (in increments of 512 bytes) 
  43.    is displayed with the total number of records, bytes remaining and  
  44.    the percentage of the file that is utilized.
  45.  
  46.    For your reference, the calculations used in these programs are:
  47.  
  48.     actual record size = 
  49.       (number of duplicate keys * 8) + record size
  50.  
  51.     number of records = 
  52.       (page size - 6) / actual record size
  53.  
  54.     bytes remaining = 
  55.       (page size - 6) - (actual record size * number of records)
  56.  
  57.     percent used = 
  58.       (((page size - 6) - bytes remaining) / (page size - 6)) * 100
  59.  
  60.  
  61.     The programs do not take into account that a larger data page size 
  62.     with slighter more bytes remaining may make more efficient use of 
  63.     disk space than a smaller page size with fewer bytes remaining. Also 
  64.     if you are using the data compression feature found in Btrieve V5.00+, 
  65.     there is no way to determine what the stored length of each record 
  66.     will be. Use your own judgement and experience in selecting a correct 
  67.     page size for a Btrieve file.
  68.  
  69.     Please notify me, ideally through CompuServe's EasyPlex, if you find 
  70.     any bugs or problems with these programs or if you have any suggestions
  71.     for improvement and enhancement. All three files have been date/time 
  72.     stamped the same as a precaution to alteration by another party. Though 
  73.     these programs have been carefully coded and tested to eliminate any 
  74.     potential problems, I am reminded by a quote from the book ...
  75.  
  76.       "The Zen of Programming" by Geoffrey James 
  77.  
  78.          'A program without bugs would be an absurdity, a nonesuch.
  79.           If there were a program without any bugs then the world
  80.           would cease to exist.'
  81.  
  82.       Thus spoke the Master Lan-Hsi to the novice.  
  83.  
  84.     If you find BTRVPAGE or PAGEBTRV to be of use, a contribution of $10 
  85.     would be greatly appreciated to defray the cost of Jolt Cola consumed
  86.     during development. However, a contribution is not necessary for you 
  87.     to enjoy these programs. 
  88.  
  89.     Also, I would consider any job offers consulting in the following areas
  90.     in lieu of a contribution. All offers will be considered. Resume and 
  91.     references upon request.
  92.  
  93.     *  Barcode Integrated Manufacturing Data Collection:
  94.        Inventory, SPC Quality Control, Time and Attendance. 
  95.        System Planning, Development, Installation and Maintenance.
  96.  
  97.     *  Engineering, Environmental and General Office:
  98.        Databases and Support Programs.
  99.  
  100.     *  Bulletin Board Systems and Local/Wide Area Networks:
  101.        BBS On-Line Databases, Network Planning and Installation.
  102.  
  103.     *  Education and Technical Curriculum Development:
  104.        Public Schools and Corporate: Computer Related Topics, Biology,
  105.        and the Social Sciences.
  106.  
  107.  
  108.     Address:  
  109.  
  110.           Charles Winser                      
  111.           21402 Lee Drive, Cabin A                        
  112.           Los Gatos, CA, 95030                         
  113.  
  114.           CompuServe: 73627,1456
  115.  
  116.  
  117.